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' QUICK REFERENCE CARD 



This card provides a complete syntax summary of all 
statements and functions in both Atari BASIC and OSS 
BASIC A+. The various keywords of the languages are 
grouped as follows: 

First: by category, with a heading for each group. A 
keyword may appear in more than one category. 
Second: within the category group, those keywords 

found in both BASICS precede those found only 
OSS BASIC A+. 

Third: within each language partition, all statements 
precede all functions. Functions are denoted by 
an T in front of the keyword. 

Finally: within each list of statements and list of 

functions, keywords are placed alphabetically. 

NOTE: All capabilities found in OSS BASIC A+ are shown 
shaded, as in this sentence. 

DEFINITION OF TERMS 

KEY V ORDS are shown in bold face type, and should be 
type: as shown. The following syntax for each keyword is 
show 1 in normal type and generally consists of zero or 
mora of the syntax items shown below. Explanations are 
shown in italics. 

Items enclosed [in square brackets] are optional. 

Enclosed items [followed by ellipses ...] may be repeated 
any number of times. 


SYNTAX ITEMS 


<stmt> any valid statement 

<stmts> 

var any VARiable 


avar an Arithemetic var 


svar a String var 


mvar a Matrix var (or 

exp 

matrix element) 

aexp 

asvar avar or svar, but 

sexp 

never mvar 

line 

filer ame a sexp used as a 


file specifier 

fn 

pm aexp used as P/M # 


addr an aexp used as a 



memory address 


any number of 
valid statements 
placed on any 
number of lines 
any expression 
an Arithmetic exp 
a String exp 
aexp used as a 
line # 

aexp used as a 
file# 


Legal forms of file specifiers: <device>:<file>.<ext> where 
<device> consists of a single letter optionally followed by 
a single digit. When the device is the disk, <file> is any 
name consisting of 1 to 8 alphanumeric characters, the 
first of which is a letter. <ext> is an optional 1 to 3 alpha¬ 
numeric characters. Here are some examples: 

E: (the screen editor) D2:MENU. SAV (a disk file 

P: (the printer) on drive 2 with the name 

R2: (RS-232 port number 2) “MENU” and the name 

extension “SAV”) 


product # 
BREF 1.0 












COMMAND & CONTROL 


BYE 

goes to memo pad 

CLR 

zeroes simple variables, 
changes all DIMs to 0 

CLOAD 

load a program from 
cassette 

CSAVE 

save a program to cassette 
ENTER filename 
only works with ATASCII 
version of a program (see 
LIST); actually a merge 
unless NEW is used first 


LIST file name 
lists program to file in 
ATASCII just as it appears 
on the screen for LIST 
alone 

LOAD filename 
load a previously SAVEd 
program 
RUN filename 
load and run a SAVEd 
program 
SAVE filename 
save a program to a file 
using internal format 


PROGRAM DEVELOPMENT 
STATEMENTS 


CLOAD 

load a program from 
cassette 

CONT 

continue a program after a 
STOP or BREAK 

CSAVE 

save a program to cassette 

END 

close all files, stop the 
program 

ENTER file name 
merges an ATASCII 
(LISTed) program into that 
already in memory 
LUST [filename] 
list program in ATASCII to 
screen or file 

LIST [filename,] line [,line] 
list only a portion of a 
program 
LOAD filename 
load a previously SAVEd 
program 


DEL line [,line] 
delete all lines in range 
specified 
LOMEM addr 
can reserve memory; does 
a NEW 

LVAR filename 
list all variables in use by 
program in memory to 
given file 


NEW 

remove all programs and 
variables from memory 
REM <any remark> 
allows commenting of 
program listings 
RUN 

begin executing program 
in memory at lowest line 
number 
RUN [filename] 
load a SAVEd program 
and start executing it 
SAVE filename 
save a program in memory 
to a file in internal format 
STOP 

halt execution of program 

f FRE(O) 

returns amount of memory 
still available 


RENUM [start][, increment] 
renumbers entire program 

TRACE 

begin displaying each 
line’s number as it is 
executed 
TRACEOFF 
cease displaying line 
numbers 




PROGRAM 

END 

close files, stop program 
FOR avar = aexp TO aexp 
[STEP aexp] <stmts>: 

NEXT avar 

traditional loop control 
GOSUB line 
call a subroutine 
GOTO line 

transfer control to new line 
IF aexp THEN 
<stmt>[:<stmt>...] 
statements after THEN are 
executed only if the aexp 
is non-zero 
IF aexp THEN line 
control is transferred to 
new line only if the aexp is 
non-zero 
NEXT -[see FORT 
ON aexp GOTO line 
[.line ...] 

ON aexp GOSUB line 
[,line...] 

if aexp = 1, control moves 
to first line given; if aexp = 

2, then to a second line; 
etc. 

CONT 

after a TRAPped error, 
continue at line after error 
ELSE {.see IF belowT 
ENDIF {see IF below > 
ENDWHILE {see WHILE } 

IF aexp : <stmts> 

[ELSE : <stmts>] 

ENDIF 

use when both ‘true’ and 
‘false’ paths are needed; 
may be nested 127 deep 

CONSOLE 

CLOSE #fn 

cease I/O to file channel fn 
GET #fn, avar 
set a single byte from fn 
INPUT [#fn,] asvar 
[.asvar...] 
input ATASCII data 
LPRINT [exp [;exp ...] 

[. exp ...]] 

output ATASCII to line 
printer 

OPEN #fn, mode, avar, 
filename 

begin I/O with filename on 
channel fn 
NOTE #fn, avar, avar 
find current position/disk 
file 

POINT #fn, avar, avar 
change current file 
position 


CONTROL 

POP 

removes last FOR, 
GOSUB, or WHILE from 
stack 

RETURN 

end of subroutine called 
by GOSUB 
RUN [filename] 
start program from 
beginning 
STEP {see FORT 
STOP 

halts program, allows 
CONT 

THEN {see IF above > 

TO {see FORT 
TRAP line 

if a subsequent error 
occurs, control is trans¬ 
ferred to line specified 


WHILE aexp: 

<stmts> 

ENDWHILE 

loops between WHILE and 
ENDWHILE so long as 
aexp is non-zero 
f ERR (aexp) 

returns last run-time error 
code 


& FILE I/O 

PRINT [#fn] 
output new line only 
PRINT exp [[; exp ...] 
[.exp...]] [;] 
output data items in 
ATASCII 

PRINT #fn [[; exp...] 

[,exp ...]] [;] 

output ATASCII items to 
a file 

PUT #fn, aexp 
output a single byte to fn 
STATUS #fn, avar 
dynamic status check 
XIO aexp, #fn, aexp, aexp, 
filename 

extended I/O operation 
? {same as PR I NTT 
usable wherever PRINT is 
legal 



CONSOLE & 

BGET #fn, addr, len 
set binary block from 
file fn 

BPUT #fn, addr, len 
put a binary block to file fn 
INPUT var [,var...] 
allows prompt to replace 

LPRINT [#fn,] USING sexp, 
[exp[,exp ...]][;] 
see special table: PR I NT 
USING 

PRINT [#fn,] USING sexp, 
[exp[,exp ... ]] [;] 
see special table: PR I NT 
USING 


FILE I/O (cont) 

RGET #fn, asvar [,asvar...] 
get data items in special 
record-oriented format 
RPUT #fn, exp [, exp ...] 
put data items in special 
record-oriented format 
TAB [#fn,] aexp 
move to given print 
column 
f TAB (aexp) 
function version only 
usable in a PRINT stmt 


MACHINE 

MOVE fromaddr, toaddr, 
lenaexp 

move any piece of memory 
to anywhere; moves 
“down” if lenaexp is 
positive (contracts); moves 
“up” if lenaexp is negative 
(expands) 

POKE addr, aexp 
change contents of 
memory location addr to 
aexp 

DPOKE addr, aexp 
change contents of WORD 
at location addr 


CONTROL 

f PEEK (addr) 
returns contents of 
memory location addr 
fUSR (addr [,aexp...]) 
calls user assembly 
language subroutine at 
addr 


f DPEEK (addr) 
returns contents of WORD 
at location addr 


OPERATOR 
PRECEDENCE TABLE 

The operators of BASIC are listed in order precedence, 
from highest to lowest. Higher precedence implies the 
operator will be executed first. Example: 3+4x5 is seen as 
3+ (4*5) because V has a higher precedence than 
( ) functions () parenthesized subexpressions 


=<>><>=<= 

NOT + - 
A 
& ! 
*/ 
+ - 

=<>><>=<= 

AND 

OR 


string comparisons [e.g., A$<> “EXIT”] 

unary operators only [e.g., -3*Z] 

exponentiation 

binary “and”, binary “or” 

multiply and divide 

add and subtract 

numeric comparisons 

[e.g., TOTAL >30] 

logical “and” (always gives 1 or 

0 result) 

logical “or” (always gives 1 or 
0 result) 

when used in array and function 
references [e.g., PRINT ARRAY (7,5)] 


NOTE: In Atari BASIC, NOT was given a precedence just 
above AND, but it does not always execute 
properly unless it is followed by a sub-expression 
in parentheses [e.g., NOT (A>B) is safe]. 







ASSIGNMENT 
& MATHEMATICS 


[LET] avar= aexp 
[LET] mvar = aexp 
arithmetic assignment; 
keyword is optional 

DEG 

selects degrees for trig 
functions 

RAD 

selects radians for trig 
functions 
f ABS (aexp) 
returns absolute value of 
argument aexp 
f ATN (aexp) 
returns arc tangent of 
argument; returns radians 
or degrees, as selected 
1 CLOG (aexp) 
returns common log (base 
10) of argument 
f COS (aexp) 

returns cosine of argument 


f EXP (aexp) 
returns ‘e’ to the power 
aexp, ‘exponentiation’ 
f INT (aexp) 

returns largest integer less 
than or equal to argument 
f LOG (aexp) 
returns natural logarithm 
of the argument 
f RND(O) 

returns a pseudo-random 
number between 0 
(inclusive) and 1 
(exclusive) 
f SGN (aexp) 

returns +1, 0,-1 according 
to the sign of the argument 
(0 only if argument is 0) 
f SIN (aexp) 

returns sine of argument 
f SQR (aexp) 
square root of argument 
f VAL (sexp) 
returns the ‘value’ of a 
number contained in a 
string 


INITIALIZATION 


CLR 

zeros numeric variables, 
sets all DIMs to zero 

DEG 

selects degrees for trig 
functions 
DIM svar (aexp) 


DIM mvar (aexp[,aexpj) 
allocate space for either a 
string or array 

RAD 

selects radians for trig 
functions 

fFRE(O) 

returns amount of memory 
still available 


LOMEM addr 
can reserve memory; does 
a NEW 


SET aexp, aexp 
see separate chart 
f SYS (aexp) 

returns value SET before 


DOS COMMANDS 

DOS 

exit to “DOS” 


CP 

same as DOS 
DIR filename 
list disk directory on 
screen 

ERASE filename 
remove file from disk 


PROTECT filename 
disallow writes and/or 
erases of given filename 
RENAME filenames 
changes name of a 
file-CAUTION: form 
must be “Dn: oldname, 
newname” 

UNPROTECT filename 
remove file protection 





STRING & CHARACTER 
HANDLING 


[LET] svar = sexp 
the destination string 
variable may be 
subscripted 
f ADR (svar) 

returns the address of the 
given string 
f ASC (sexp) 
returns numeric value of 
first byte of given string 

[LET] svar = sexp [,sexp...] 
allows concatenation of 
several strings 


i CHR$ (aexp) 
returns a one byte string— 
character has a value of 
aexp 

f LEN (sexp) 
returns length of string 
1 STR$ (aexp) 
returns a string equivalent 
to what would be visible if 
aexp were PRINTed 

f FIND (sexp, sexp, aexp) 
finds location of 2nd str 
within 1st string starting at 
given position plus one 


GRAPHICS, SOUND, & 
PLAYER/MISSILE GRAPHICS 


COLOR aexp 
choose a color for 
subsequent PLOT and 
DRAWTO 

DRAWTO aexp, aexp 
draw a line from last point 
PLOT ted or drawn to 
GRAPHICS aexp 
choose a graphics mode 
LOCATE aexp, aexp, avar 
find what color a given 
point on the screen is 
PLOT aexp, aexp 
plot a single point (pixel) 
POSITION aexp, aexp 
set screen location cursor 


MISSLE pm, aexp, aexp 
“shoot” a missile 
PMCLR pm 
clear a player area 
PMCOLOR pm, aexp, aexp 
change a player color- 
same format as 
SETCOLOR 
PMGRAPHICS aexp 
select player/missile mode 
PMMOVE pm[,aexp] [;aexp] 
move.a player or missile 
PMWIDTH pm, aexp 
change player/missile 
width 


SETCOLOR aexp, aexp, 
aexp 

change color register 
values; order is register 
number, hue, luminance 
SOUND aexp, aexp, aexp, 
aexp 

change sound register 
values; order is register 
number, frequency, 
waveform, volume 
1 PADDLE (aexp) 
get current paddle value 
1 PTRIG (aexp) 
returns 0 if trigger pushed 
f STICK (aexp) 
get current joystick 
position 
fSTRIG (aexp) 
returns 0 if trigger pushed 

1 BUMP (pmnum, aexp) 
check for player/missile 
and/or play field collisions 
f HSTICK (aexp) 
returns-1, 0, +1 if joystick 
is left, center, right 
f PEN (aexp) 
returns light pen values 
f PMADR (pm) 
gets address of a player or 
missile 

fVSTICK (aexp) 
returns-1, 0, +1 if joystick 
is down, center, up 



Optimized Systems Software, Inc. 
10379 Lansdale Avenue 
Cupertino, CA 95014 
Telephone (408) 446-3099 



IN-MEMORY 
DATA HANDLING 


DATA <ATASCII data> 
data may contain any 
characters except a 
comma 

READ asvar [,asvar...] 
evaluate next data from 
DATA statement(s) and 
place in specified variable 

DATA [“<quoted data>”] 
[<ATASCII data>] 
if data is quoted may 
contain any characters 
except another quote 


RESTORE [line] 
move data pointer to given 
line number, (or beginning 
of program) 


READ var [,var...] 
may read directly into 
subscripted array elements 
or substrings 


BASIC ERROR MESSAGES 


Number Message 

Number Message 

1 

Break Key Abort 

16 

RETURN With No 

2 

Memory Full 


Matching GOSUB 

3 

Value (usually num 

17 

Bad Line (syntax 


too big) 


error/line) 

4 

Too Many Variables 

18 

Not Numeric (VAL func. 

5 

String Length 


error) 

6 

No More Data Available 

19 

Program Too Big 


For Read 


To Load 

7 

Line Or Input Value 

20 

File Number Invalid 


>32767 

21 

Not A SAVEd Program 

8 

Input Or Read 




Data Error 

22 

‘USING’ Format 

9 

Dimension Error 

23 

‘USING’Too Big 

10 

Expression Too 

24 

‘USING’Type 


Complex 

25 

Dimension Mismatch 

11 

Floating Point Overflow 


(RGET) 

12 

No Such Line Number 

26 

Type Mismatch (RGET) 

13 

NEXT, With No 

27 

INPUT Abort 


Matching FOR 

28 

Nesting 

14 

Line Too Long 

29 

Player/Missile Number 

15 

Line Deleted 

30 

PM Graphics Not Active 


(GOSUB, FOR or 

32 

End of‘ENTER’ 


WHILE) 




CIO ERROR 

MESSAGES 

128 

Break Abort 

133 

File Not Open 

129 

File Number Already 

134 

Bad File Number 


Open 

135 

File Is Read Only 

130 

Nonexistent Device 

136 

End Of File 

131 

File Is Write Only 

137 

Truncated Record 

132 

Invalid Command 




SIO ERROR 

MESSAGES 

138 

Device Timeout 

142 

Serial Bus Overrun 

139 

Device NAK (refuses 

143 

Serial Bus Checksum 


command) 



140 

Serial Bus Frame Error 



S: 

(Screen) ERROR MESSAGE 

141 

Cursor Out Of Range 




HARDWARE ERROR 
MESSAGES 

144 Device Error (usually 145 Read/Write Verify 

write protected disk) 146 Invalid Function 





SET/SYS VALUES 


SET is used to configure certain BASIC A* system 

parameters. The companion function SYS( ) may be used 
to find out what the configuration is at any point in time. 


The format is: SET parameter rubber *5 je. A number in 
parentheses is the “power-on” d^'ault value. 

Parameter Values Meanings 


Number 

0 


(0) BREAK key functions normally. 

1 BREAK causes trappable error. 

128 BREAKS are ignored. 

1 to 127 Tab sire *or comma in PRINT (10). 

0 to 255 Prom r»t character for INPUT 
(63, 

(0) FOR ... NEXT loops execute at least 


1 

4 0 

(D 

5 0 
(D 

6 ( 0 ) 
1 

7 (0) 
1 

8 0 
( 1 ) 

9 (0) 

1 


once. 

FOR loops may execute zero times. 
Reprompt user if too little 
INPUT data. 

No reprompt, a TRAPpable error 

occurs. 

Lower case/inverse video 
unchanged. 

For program entry ONLY, lower case 
& inverse video converted to 
upper case. 

Print error messages and error 
numbers. 

Print only error numbers. 
Player/missiles will NOT wrap 
around. 

Player/missiles wrap around from 
top to bottom and vice versa. 

No parameter count push for 
USR calls. 

DO push the count of parameters. 
ENTER statements work like 
Atari BASIC. 

End of an ENTER is treated as a 
trappable error. 


PRINT USING TABLE 

Symbol Result 

#... Blank Fill On Left 
*... Asterisk Fill On Left 
& ... Zero Fill On Left 

, Numeric Comma Placeholder 
. Numeric Decimal Point Placeholder 
$ Fixed Dollar Sign 
$... Floating Dollar Sign 
4-... Floating Forced Sign (+ or-) 

Floating Minus Sign (Blank or-) 

%... Right Justified String 
!... Left Justified String 
+ Leading Or Trailing Fixed Forced Sign 
(+ or-) 

- Leading Or Trailing Fixed Minus Sign 
(Blank or-) 

/X Escape Sequence (X is ANY character 
and is forced whether in a format or not) 







